home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / psrch2b.arc / PSEARCH.TXT < prev    next >
Encoding:
Text File  |  1986-04-17  |  7.9 KB  |  195 lines
  1. PSEARCH version 2.0    by    Norm Patriquin           April 1986
  2. ----------------------------------------------------------------
  3.  
  4.  
  5. How PSEARCH can save you time ---
  6.  
  7. PSEARCH is a file and text find utility for use on the IBM
  8. personal computer.  It is not only a good technicians tool, it
  9. provides an easy to use, quick, way for users to locate files
  10. when their name has been forgotten or misplaced.  This document
  11. describes how PSEARCH can benefit users with various different
  12. needs.
  13.  
  14.  
  15. Word Processing Users
  16. ---------------------
  17.  
  18. PSEARCH has the ability to locate a file by words in its
  19. contents.  This provides you with a facility to locate your word
  20. processing files by keywords or other information.  The following
  21. command will print the names of all files that contain the name
  22. "Jones":
  23.  
  24.       PS *.*/t:jones
  25.  
  26. If you do not have keywords to search for, you can examine the
  27. contents of files to locate a file needed.  PSEARCH will scan the
  28. files matching the wildcard specification and show you the first
  29. words in the file.  By looking at these words you will easily be
  30. able to identify the contents of each one.
  31.  
  32. The next command will produce a report of the contents of all
  33. files.  Only one line of words from each file will be displayed.
  34. This line usually will contain the title of the document or a
  35. letter or memo heading that will identify the document.
  36.  
  37.       PS *.*/s/d/p
  38.  
  39.  
  40. Spreadsheet Users
  41. -----------------
  42.  
  43. How many times have you forgotten the name of a spreadsheet you
  44. created or needed to locate a spreadsheet from another users
  45. files.  After awhile names are very poor identifiers for files.
  46. PSEARCH can examine spreadsheet files and locate specific file
  47. names based on keywords found in the spreadsheet file.  The
  48. following command will show the names of all spreadsheet files
  49. that contain the word "budget".  The example below refers to all
  50. files with extension .WKS.  This is for 123 spreadsheet files.
  51.  
  52.        PS *.WKS/t:budget
  53.  
  54. If you do not have a keyword to look for, you can examine the
  55. contents of worksheet files to determine what they are.  PSEARCH
  56. will look for the first text data in the spreadsheet file and
  57. show you that information.  Since the first text in the file is
  58. usually title or the column header information, it is easy to
  59. identify the contents of the file.
  60.  
  61. The following command example will cause PSEARCH to show the text
  62. contents of all files that satisfy the wildcard filename
  63. criteria.  The /P (Pause) parameter will allow you to see more
  64. than one line of text information of each file if desired.  You
  65. will be prompted after each line of text is shown.
  66.  
  67.        PS *.WKS/f/s/p
  68.  
  69.  
  70. Program Developers
  71. ------------------
  72.  
  73. PSEARCH's ability to scan for text in files can greatly reduce
  74. the time developers use to locate specific parts of code or
  75. references to field variables.  PSEARCH can search for any
  76. specific string, complete words, word prefixes, or word suffixes.
  77. Once files are found, you can automatically build DOS commands to
  78. be executed against them.  PSEARCH's ability to locate complete
  79. words is invaluable in finding references to short variable names
  80. that are also likely to be found as parts of other words.  This
  81. makes it more powerful than most text search facilities found in
  82. editors.
  83.  
  84.  
  85. General Disk File Maintenance
  86. -----------------------------
  87.  
  88. In addition to PSEARCH's ability to search for text in files, it
  89. also contains the most complete file find facility to be found.
  90. PSEARCH can search across multiple directories, even multiple
  91. disk drives, for file names.  The search can be limited to
  92. specified wildcard names and also be limited to the other
  93. following criteria:
  94.  
  95.         ---     File Attribute UPDATED, READONLY, SYSTEM
  96.         ---     FIles greater than nnn days old
  97.         ---     Files less than nnn days old
  98.  
  99. In addition to searching for files recorded in DOS directories,
  100. PSEARCH can also find filenames that are stored in archive files
  101. created by the ARC utility by System Enhancement Associates.
  102. This allows you to quickly locate files that have been archived.
  103. In addition,  through, PSEARCH's DOS command execution, you may
  104. automatically cause PSEARCH to unarchive the file.
  105.  
  106. Since PSEARCH can execute any DOS command against files selected,
  107. it can perform unlimited file maintenance activities.  For
  108. example, the following command causes PSEARCH to archive all
  109. files with a .BAS extension that is also over 30 days old:
  110.  
  111.         PS *.BAS/f/a/o:30/x:arc m BAS.ARC #
  112.  
  113.    DOS command interface parameters and command structure.
  114.    -------------------------------------------------------
  115.  
  116.    PS [filespec] /F/E/A/DR:xx/P/MO/PR/PF/AO/AR/N:n/O:n/SO/X:xx/AT:x/T:xx/C/D/M
  117.  
  118.    ------------------------  GENERAL COMMAND PARAMETERS  ---------------------
  119.  
  120.    /F  - Locate file (not text search)     /E  - Show directory tree
  121.    /A  - Search all directories            /DR:xyz Scan drives x,y,z
  122.    /P  - Pause after every match           /MO - Pause when screen full
  123.    /PR - Print output on printer           /PF - Print output to file
  124.    /AR - Find Files in .ARC files          /AO - Only process .ARC files
  125.    /N - N:nnn Select files < n days old    /O - O:nnn Select if > n days old
  126.    /SO - Set Sound Off
  127.    /AT: [U][H][S][R] Select Updated, Hidden, System, or Readonly file files
  128.  
  129.  
  130.    -----------------  TEXT SEARCH RELATED PARAMETERS  -------------------------
  131.    /T  - T:text   Text to be found         /C  - Case sensitive search
  132.    /D  - Display matching records          /M  - Show all matches
  133.    /FW - Find text as a word               /FP - Find text as word prefix
  134.    /FS - Find text as word suffix          /SK - Skip COM,EXE and BAT files
  135.  
  136.  
  137.    -----------------  EXECUTE COMMAND FOR SELECTED FILES  ---------------------
  138.  
  139.    /X - X:cmd & aa    Execute command for each found file
  140.       The following characters found in command are replaced as follows:
  141.         & - Path name      ! - File name without extension      @ - / for parms
  142.         # - file name      ~ - Name of file in .ARC
  143.    /XF:cmd & aa  Like /X to command file   /XP:cmd & aa  Like /X with Pause
  144.       \0 };
  145.  
  146.  
  147.  
  148.   Examples:
  149.   ---------
  150.   Find a file on your disk:                  PS TOMS.DAT/F/A
  151.   Find a group of files:                     PS TOMS*.*/F/A
  152.   Show files containing the characters XYZ:  PS *.*/T:XYZ
  153.        Also show the matching lines:         PS *.*/T:XYZ/D/M
  154.   List all files updated in last 3 days      PS *.*/N:3
  155.   List all files older than 6 months         PS *.*/O:182
  156.   Copy files older than 1 year to drive A:
  157.               PS *.*/O:366/X:copy # B:
  158.   Use ARC utility to archive any .WKS files over 1 year old
  159.               PS *.WKS/O:366/X:ARC A OLDSTUFF.ARC #
  160.   Delete .WKS files older than 1 year
  161.               PS *.WKS/O:366/X:ERASE #
  162.   Search all 123 files for word BUDGET
  163.               PS *.WKS/D/T:BUDGET
  164.   Compile all programs that contain the string 'DATAREC1'
  165.               PS \pgmdir\*.C/T:DATAREC1/x:compile !
  166.   Build a command file for manually selected file names
  167.               PS *.*/A/XP:ARC A SAVE.ARC #
  168.  
  169. General Comments
  170. ----------------
  171.  
  172. The examples shown above all demonstrate PSEARCH's DOS command
  173. format.  PSEARCH also may be started to display menus for option
  174. selection.  This makes it easy to use for novices.  The menus
  175. provide the basic PSEARCH functions and allow for options to be
  176. specified.
  177.  
  178. PSEARCH is available on many fine bulletin boards under the
  179. following names:
  180.  
  181.        PSEARCH.ARC
  182.        PSRCH?.ARC
  183.  
  184. Note that each version of PSEARCH is supplied  with the program
  185. file and a multiple page documentation file.  If you are unable
  186. to locate PSEARCH or would like to obtain a new complete copy,
  187. send the $15 registration fee plus $5 shipping and handling to:
  188.  
  189.     Norm Patriquin
  190.     P. O. Box 8308
  191.     San Bernardino, CA  92412
  192.  
  193. Please indicate where to found out about PSEARCH and a complete
  194. address where your new copy can be delivered.
  195.